home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 351-375 / disk_353 / northc / northc1.lzh / CONTENTS < prev    next >
Text File  |  1990-05-01  |  9KB  |  299 lines
  1.   NorthC 1.1 provides an selection of programs, documentation and examples, if 
  2. your version does not contain all the following you should complain to the 
  3. person you got it from.
  4.  
  5.  
  6. hello.doc
  7.  
  8.     A quick introduction to 'C' under NorthC, read this if you have never
  9.   used 'C' before.  Also because this takes you through the steps for 
  10.   producing programs under "NorthC:" it might even be worth looking at if 
  11.   you are converting from another system.
  12.  
  13.  
  14. setup-NorthC
  15.  
  16.     A script file to set the path and create a logical device "clibs:" you
  17.   should run this each time you use NorthC.  This script file runs 
  18.   "Single-Disk", "Dual-Disk" or "Hard-Disk" depending on your system.  You 
  19.   will have to edit the file to tell it what type of system you have.
  20.  
  21.  
  22. Single-disk
  23.  
  24.     A script file to set up an unexpanded Amiga 500 to compile the "Hello
  25.   World" program, after you have used it once you should go out and buy a 
  26.   second drive then use "setup-NorthC".
  27.  
  28.  
  29. Dual-Disk
  30.  
  31.     A script file to set up NorthC on an Amiga with a second floppy drive, 
  32.   once you are familiar with the system you will probably want to configure 
  33.   your system slightly differently.  Normally I put the "NorthC", "A68K", 
  34.   "Blink" and "make" programs in the "c:" directory of a cut down system 
  35.   disk, for example.
  36.  
  37.  
  38. Hard-Disk
  39.  
  40.     A script file to set up NorthC on an Amiga with a hard disk, look at the 
  41.   file in an editor before you run it!  I have not got a hard disk so this is 
  42.   just a guess of what you might want to do, well if you can afford a Hard 
  43.   disk you should know enough to set it up.
  44.  
  45.  
  46. README
  47.  
  48.     A quick introduction to the astounding bonuses of using the best value 
  49.   for money 'C' compiler for the Amiga.
  50.  
  51.  
  52. CONTENTS
  53.  
  54.     A list of the contents of the "NorthC:" disk, this file in fact.
  55.  
  56.  
  57. tools/ar.c  tools/cc.c  tools/ar.blink  tools/cc.blink  tools/Makefile
  58.  
  59.     The source files for the ar and cc programs, the command "make" will 
  60.   recompile these files for you.  These are here mainly as examples that are 
  61.   garenteed to compile with NorthC.  Also cc.c is a good program to hack 
  62.   about a bit if you want to change your top level interface.
  63.  
  64.  
  65. libs
  66.  
  67.     The 'C' library files, this directory contains the files NorthC requires
  68.   for the standard library and the startup routines.  The files in this 
  69.   directory are listed below.
  70.  
  71.  
  72. libs/libc.doc
  73.  
  74.     Documentation on the 'C' library routines currently implemented in the 
  75.   'C' library.  This document should be printed out and often refered to.
  76.  
  77.  
  78. libs/clibdefs.i
  79.  
  80.     Some macros to use in assembler routines, these are specifically made
  81.   to suit my programming style, feel free to steal any ideas you think are 
  82.   usefull.
  83.  
  84.  
  85. libs/dos.i
  86.  
  87.     A list of the standard AmigaDOS library offsets, this list does not match 
  88.   the latest release of the operating system.  You will only need to use 
  89.   this file when calling the operating system from assembler.
  90.  
  91.  
  92. libs/libc.a
  93.  
  94.     The standard 'C' library, the functions in this library attempt to follow 
  95.   the ANSI standard, see "libc.doc" for a list of the functions implemented.
  96.   The maths routines use Motorola Fast Floating Point format, the "double" 
  97.   data format in NorthC is 32 bits.
  98.  
  99.  
  100. libs/crt0.o
  101.  
  102.     The startup routine, this will load up the libraries, open a console,
  103.   and generally do the things startup routines are supposed to.  Examine the
  104.   source code for details of what it does.
  105.  
  106.  
  107. libs/crt0.asm
  108.  
  109.     The source for the startup routine, alter this if you do not like the
  110.   startup, but remember to note the fact in the file.  It is important that
  111.   you call "__main" not "_main" otherwise some things will not be 
  112.   initialised correctly.
  113.  
  114.  
  115. libs/AmigaDOS.doc
  116.  
  117.     This file lists the AmigaDOS routines that the 'C' library supports, the 
  118.   main bulk of this file was generated from the 1.3 ".fd" files on the 
  119.   system disk.
  120.  
  121.  
  122. bin
  123.  
  124.     This directory contains the compiler, assembler, linker and front end 
  125.   for NorthC, these mostly come from other people see the documentation for 
  126.   the sources.
  127.  
  128.  
  129. bin/NorthC
  130.  
  131.     The compiler, this will translate 'C' source into assembler files.  
  132.   Read the file "bugs.doc" to find details of the current release.
  133.  
  134.  
  135. bin/a68k  bin/A68k.doc
  136.  
  137.     The assembler from Charlie Gibbs, again the doc file gives more details.
  138.   This translates assembler files into object files.
  139.  
  140.  
  141. bin/Blink   bin/Blink.doc
  142.  
  143.     The linker from "The Software Distillary", see the doc file for details.
  144.   This combines object files and libraries to produce executable programs.
  145.  
  146.  
  147. bin/Bugs.doc
  148.  
  149.     A list of known bugs in this version of NorthC, this includes work 
  150.   arounds for many of the bugs.  It is important to read this document when 
  151.   you find your program not behaving as it should.
  152.  
  153.  
  154. bin/make bin/make.doc
  155.  
  156.     The make program, I have supported the basic elements of "make" but some 
  157.   elements, such as variables, are missing.
  158.  
  159.  
  160. bin/cc  bin/cc.doc
  161.  
  162.     The front end, this will control the compiler assembler and linker.  This
  163.   program loosly follows the normal UNIX conventions, however it needs to be
  164.   hacked before it does everything you will need.
  165.  
  166.  
  167. bin/ar
  168.  
  169.     The library creator, note this takes a very simple view of creating 
  170.   libraries, it just concatenates files together.  See the tools directory
  171.   to examine the source.
  172.  
  173.  
  174. bin/CHANGES
  175.  
  176.     This file lists the changes that have been made to NorthC in each release, 
  177.   it will be of most use if you are updating an old NorthC disk.
  178.  
  179.  
  180. include
  181.  
  182.     This directory contains the "include" files, these are accessed by a line 
  183.   in the code such as
  184.  
  185.     #include <stdio.h>
  186.  
  187.   the '<' and '>' indicate that the file is to be found in the include 
  188.   directory.  The compiler automatically looks in the ":include" directory 
  189.   for the include files, if you want it to look elsewhere change the 
  190.   "INCLUDE" environment variable.
  191.  
  192.  
  193. include/string.h include/ctype.h  include/stdarg.h include/assert.h
  194. include/stddef.h include/stdio.h  include/errno.h  include/macros.h
  195. include/setjmp.h include/limits.h include/time.h   include/stdlib.h
  196. include/types.h  include/math.h
  197.  
  198.     The standard 'C' include files, this set comes originally from the
  199.   Sozobon 'C' compiler.
  200.  
  201.  
  202. include/exec include/graphics include/intuition include/libraries
  203.  
  204.     There are selected parts of selected include files within these
  205.   directories, these were the bare minimum to allow me to get at the 
  206.   operating system.  The "Amiga ROM Kernel Reference Manual: Includes & 
  207.   Autodocs" contains full listings of the contents of all the include 
  208.   files.
  209.  
  210.  
  211. examples
  212.  
  213.     This directory contains some simple examples that have been ported to
  214.   NorthC, these sources should be looked at to get ideas from.
  215.  
  216.  
  217. examples/hello
  218.  
  219.     This is a bare directory to create the "hello.c" program in.
  220.  
  221.  
  222. examples/CRender
  223.  
  224.     This directory contains an example program, this program draws three 
  225.   dimensional solid models, it also calls intuition and some graphics 
  226.   routines.
  227.  
  228.  
  229. examples/CRender/CRender
  230.  
  231.     This is the NorthC rendering program, it displays three dimensional 
  232.   models.
  233.  
  234.  
  235. examples/CRender/CRender.doc  examples/CRender/aif.doc  
  236. examples/CRender/render.doc   examples/CRender/Makefile.doc
  237.  
  238.     These file give some documentation for the CRender program, they go into 
  239.   some details about three dimensional maths, and give you no help at all 
  240.   about intuition and using Amiga graphics routines.  Oh well at least you 
  241.   can look in the source code.
  242.  
  243.  
  244. examples/CRender/3d.h  examples/CRender/aif.c  examples/CRender/render.c
  245. examples/CRender/req.c examples/CRender/requester.h
  246. examples/CRender/menustrip.h
  247.  
  248.     The source code to the CRender program, this includes the code to set 
  249.   up the menu strip and a simple requester.
  250.  
  251.  
  252. examples/CRender/Makefile  examples/CRender/CRender.blink
  253.  
  254.     The files for "make", each time you alter some of the source code you 
  255.   should run "make", it will use these two files to bring the program up to 
  256.   date.
  257.  
  258.  
  259. examples/CRender/objects
  260.  
  261.     This directory conatins some example objects for display.
  262.  
  263.  
  264. examples/CRender/objects/ball.dat   examples/CRender/objects/boat.dat
  265. examples/CRender/objects/cube.dat   examples/CRender/objects/oct.dat
  266. examples/CRender/objects/tetra.dat  examples/CRender/objects/try.dat
  267.  
  268.     These files contain some example objects that have been created to 
  269.   display with the CRender program.  All the objects are rather simple 
  270.   except the boat.  To display an object, for example the ball, type the 
  271.   commands
  272.  
  273.     cd NorthC:examples/CRender
  274.     CRender objects/ball
  275.  
  276.   the object will then be rotated on the screen.
  277.  
  278.  
  279. examples/Unpack
  280.  
  281.     This directory contains a quick 'C' program to call script files and 
  282.   OS commands, used on the distribution disk to uncompress the NorthC 
  283.   disk.
  284.  
  285.  
  286. examples/Unpack/Unpack.c
  287.  
  288.     The source for the "Unpack" program.
  289.  
  290.  
  291. examples/Unpack/Makefile  examples/Unpack/unpack.blink
  292.  
  293.     The support for "make" for the "Unpack" program.
  294.  
  295.  
  296. examples/Unpack/unpack
  297.  
  298.     The "Unpack" program itself.
  299.